home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 2004 #2 / Amiga Plus CD - 2004 - No. 02.iso / AmiSoft / Dev / cross / Annotate.lha / annotate / Annotate.readme < prev    next >
Encoding:
Text File  |  2003-12-23  |  3.0 KB  |  78 lines
  1. Short:    Comments/reformats DASMX 2650 cross-disasms
  2. Uploader: amigansoftware@abime.net (James Jacobs)
  3. Author:   amigansoftware@abime.net (James Jacobs)
  4. Type:     dev/cross
  5. Version:  1.11
  6.  
  7. ANNOTATES reformats the output of the DASMX cross-disassembler to make
  8. it more readable (by adding pseudo-C endline comments), and more
  9. compatible with the VACS cross-assembler. Both of those programs are for
  10. the IBM-PC. ANNOTATE is intended for Emerson Arcadia 2001 console
  11. retroprogrammers, although it may be useful in regard to development for
  12. other platforms which also use the Signetics 2650 CPU.
  13.  
  14. There are six different 'levels' of operation. Each higher level adds
  15. additional annotation; ie. the highest level gives the friendliest, most
  16. detailed output.
  17.  
  18. 1: (a) Convert tabs to spaces.
  19.    (b) Convert ",+" and ",-" postincrement/postdecrement notation to "+"
  20.        and "-", respectively.
  21.    (c) Convert literals to "$x"-style.
  22.    (d) Convert labels at $2000 or later to literals.
  23.    (e) Append ",r3" to operand after BXA and BSXA opcodes.
  24.    (f) Append "end" to end of file.
  25.    (g) Remove DASMX comments.
  26.    (h) Insert 2650 equates.
  27. 2: (a) Append pseudo-C comments.
  28. 3: (a) Insert hardware equate definitions.
  29.    (b) Convert hardware registers from literals to constants.
  30. 4: (a) Append memory purpose information to memory access comments.
  31. 5: (a) Insert hardware equate comments.
  32. 6: (a) Append byte-lengths of each instruction.
  33.  
  34. You *must* feed it unmodified DASMX output, which has been disassembled
  35. with the 'numformat I' option. 
  36.  
  37. You use it from the command line. All output from the program goes to the
  38. standard output (normally the console), and thus can be piped or
  39. redirected as desired.
  40.  
  41. Usage is as follows:
  42.  
  43.     1> Annotate [FILE=]<filename> [LEVEL=<number>] [AMIGA]
  44.  
  45. The template is:
  46.  
  47.     FILE/A,LEVEL/N,AMIGA/S
  48.  
  49. FILE is the input filename. LEVEL is the level number as explained above.
  50. The default level is 6 (ie. the most detailed output). The AMIGA keyword
  51. will cause carriage returns found in the input to be omitted on the
  52. output; ie. to use Amiga-style end-of-line (EOL) sequences (LF) rather
  53. than IBM-PC ones (CR+LF). This is more convenient for manipulation of the
  54. output on an Amiga but is not acceptable to VACS.
  55.  
  56. Output is to the console by default; use redirection to create an
  57. output file. For example:
  58.  
  59.     1> Annotate ROBOTKI1.ASM >ROBOTKI2.ASM
  60.  
  61. SAS/C source code is included. Also included is an example disassembly of
  62. the Robot Killer game. ROBOTKI1.ASM is the unmodified DASMX output,
  63. disassembled with the 'numformat I' option of course. ROBOTKI2.ASM is the
  64. result of using ANNOTATE on ROBOTKI1.asm, and will assemble under VACS
  65. without any changes required.
  66.  
  67. The EA2001 Patching Guide at http://geocities.yahoo.com/amigansoftware/
  68. patching.txt has detailed information about disassembly, annotation and
  69. patching of EA2001 games.
  70.  
  71. URL:   http://www.users.bigpond.com/james.jacobs/
  72. EMail: amigansoftware@abime.net
  73.  
  74.                                         Enjoy!
  75.                                         James Jacobs of Amigan Software
  76.  
  77.                                         23/12/03
  78.